home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / SCOpen.z / SCOpen
Text File  |  1998-10-30  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSCCCCOOOOppppeeeennnn((((3333))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         SSSSCCCCOOOOppppeeeennnn((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SCOpen, SCOpenScreen, SCOpenFile - establishing a connection with a
  10.      scanning device
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccaaaannnnnnnneeeerrrr....hhhh>>>>
  15.  
  16.      SSSSCCCCAAAANNNNNNNNEEEERRRR ****SSSSCCCCOOOOppppeeeennnn((((cccchhhhaaaarrrr ****nnnnaaaammmmeeee))));;;;
  17.  
  18.      SSSSCCCCAAAANNNNNNNNEEEERRRR ****SSSSCCCCOOOOppppeeeennnnSSSSccccrrrreeeeeeeennnn((((cccchhhhaaaarrrr ****ssssccccrrrreeeeeeeennnn))));;;;
  19.  
  20.      SSSSCCCCAAAANNNNNNNNEEEERRRR ****SSSSCCCCOOOOppppeeeennnnFFFFiiiilllleeee((((cccchhhhaaaarrrr ****ffffiiiilllleeee))));;;;
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      _S_C_O_p_e_n establishes a connection with the scanning device specified by
  24.      _n_a_m_e.  If _n_a_m_e is NULL, the default scanning device is used.  Scanner
  25.      device names are matched to scanner drivers and scanner devices by
  26.      entries in the file /_u_s_r/_l_i_b/_s_c_a_n/_s_c_a_n_n_e_r_s, which is maintained using the
  27.      _s_c_a_n_n_e_r_s(1M) tool.
  28.  
  29.      _S_C_O_p_e_n_S_c_r_e_e_n starts the screen scanner driver to enable scanning from
  30.      _s_c_r_e_e_n.
  31.  
  32.      _S_C_O_p_e_n_F_i_l_e starts the file scanner driver to enable scanning from _f_i_l_e.
  33.  
  34. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  35.      _S_C_O_p_e_n, _S_C_O_p_e_n_S_c_r_e_e_n, and _S_C_O_p_e_n_F_i_l_e each return a pointer to a SSSSCCCCAAAANNNNNNNNEEEERRRR
  36.      structure, whose structure definition is private to _l_i_b_s_c_a_n(3).  This
  37.      parameter is used for future _l_i_b_s_c_a_n(3) calls.
  38.  
  39.      In the event of an error, _S_C_O_p_e_n, _S_C_O_p_e_n_S_c_r_e_e_n, and _S_C_O_p_e_n_F_i_l_e return
  40.      NULL, and _S_C_e_r_r_n_o is set indicate the reason.
  41.  
  42. EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
  43.      _S_C_O_p_e_n, _S_C_O_p_e_n_F_i_l_e, and _S_C_O_p_e_n_S_c_r_e_e_n will fail under the following
  44.      circumstances.
  45.  
  46.      SCENOSCANNERS            No scanners are installed
  47.  
  48.      SCENODRIVER              Driver does not exist
  49.  
  50.      SCENOMEM                 Out of memory
  51.  
  52.      SCENOSCANNER             No such scanner
  53.  
  54.      SCEDEV                   Scanner driver error
  55.  
  56.      SCEDRVMSG                Driver specific error.  _S_C_E_r_r_o_r_S_t_r_i_n_g(3) will
  57.                               return a custom message supplied by the scanner
  58.                               driver
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSCCCCOOOOppppeeeennnn((((3333))))                        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                         SSSSCCCCOOOOppppeeeennnn((((3333))))
  71.  
  72.  
  73.  
  74.      In addition, these functions may fail as the result of a failed system
  75.      call, in which case _S_C_e_r_r_n_o will be set to a value from <_s_y_s/_e_r_r_n_o._h>.
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      _s_c_a_n_n_e_r_s(1M), _l_i_b_s_c_a_n(3), _S_C_C_l_o_s_e(3), _S_C_G_e_t_S_c_a_n_E_n_t(3), _S_C_G_e_t_U_s_e_r_I_n_f_o(3).
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.